Documentation fixes

Make sure all types show up in the docs,
and misc other improvements.

diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index efb544edc66c04a396786179c851aa75c0ea7829..41b59c5c652a2c071bda0ae2ce607d874f1b4488 100644 (file)
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -7296,12 +7296,15 @@ GtkConstraintTarget
 gtk_constraint_new
 gtk_constraint_new_constant
 gtk_constraint_get_target
+GtkConstraintAttribute
 gtk_constraint_get_target_attribute
+GtkConstraintRelation
 gtk_constraint_get_relation
 gtk_constraint_get_source
 gtk_constraint_get_source_attribute
 gtk_constraint_get_multiplier
 gtk_constraint_get_constant
+GtkConstraintStrength
 gtk_constraint_get_strength
 gtk_constraint_is_required
 gtk_constraint_is_attached

diff --git a/docs/reference/gtk/gtk4.types.in b/docs/reference/gtk/gtk4.types.in
index 8073f3ad20055fa5d40213fbe51fe3abec059378..a03901d769b956920ec2c659d7b21f8e9beaeb16 100644 (file)
--- a/docs/reference/gtk/gtk4.types.in
+++ b/docs/reference/gtk/gtk4.types.in
@@ -49,6 +49,10 @@ gtk_color_chooser_dialog_get_type
 gtk_color_chooser_widget_get_type
 gtk_combo_box_get_type
 gtk_combo_box_text_get_type
+gtk_constraint_get_type
+gtk_constraint_guide_get_type
+gtk_constraint_layout_get_type
+gtk_constraint_target_get_type
 gtk_container_get_type
 gtk_css_provider_get_type
 gtk_dialog_get_type

diff --git a/gtk/gtkconstraintguide.c b/gtk/gtkconstraintguide.c
index cb40ff07626222d354d148794d77609449195808..2ae28aac0ed0cf362e886cf4595e1672190758ce 100644 (file)
--- a/gtk/gtkconstraintguide.c
+++ b/gtk/gtkconstraintguide.c
@@ -22,9 +22,10 @@
  * @Title: GtkConstraintGuide
  * @Short_description: An invisible constraint target
  *
- * #GtkConstraintGuide is an invisible layout element that can be used by
- * widgets inside a #GtkConstraintLayout as a source or a target of a
- * #GtkConstraint.
+ * A #GtkConstraintGuide is an invisible layout element that can be
+ * used by widgets inside a #GtkConstraintLayout as a source or a target
+ * of a #GtkConstraint. Guides can be used like guidelines or as
+ * flexible space.
  *
  * Unlike a #GtkWidget, a #GtkConstraintGuide will not be drawn.
  */

diff --git a/gtk/gtkconstraintlayout.c b/gtk/gtkconstraintlayout.c
index 32fdb4f1429ea95814f625430cff87ff68345c47..751f2d8965e75e490d3b6fe37e5dda9634e57253 100644 (file)
--- a/gtk/gtkconstraintlayout.c
+++ b/gtk/gtkconstraintlayout.c
@@ -1097,6 +1097,7 @@ gtk_constraint_layout_new (void)
  *    widget using @layout
  *  - set to the #GtkWidget using @layout
  *  - set to a child of the #GtkWidget using @layout
+ *  - set to a guide that is part of @layout
  *
  * The @layout acquires the ownership of @constraint after calling
  * this function.
@@ -1252,12 +1253,12 @@ gtk_constraint_vfl_parser_error_quark (void)
  * @n_lines: the number of lines
  * @hspacing: default horizontal spacing value, or -1 for the fallback value
  * @vspacing: default vertical spacing value, or -1 for the fallback value
- * @views: (element-type utf8 Gtk.Widget): a dictionary of [ name, widget ]
+ * @views: (element-type utf8 Gtk.ConstraintTarget): a dictionary of [ name, target ]
  *   pairs; the `name` keys map to the view names in the VFL lines, while
- *   the `widget` values map to children of the widget using a #GtkConstraintLayout
+ *   the `target` values map to children of the widget using a #GtkConstraintLayout, or guides
  * @error: return location for a #GError
  *
- * Creates a list of constraints they formal description using a compact
+ * Creates a list of constraints from a formal description using a compact
  * description syntax called VFL, or "Visual Format Language".
  *
  * The Visual Format Language is based on Apple's AutoLayout [VFL](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/AutolayoutPG/VisualFormatLanguage.html).